SnapPOS Register - setup (Linux)
================================

1. Make sure the SnapPOS server (the main till PC) is turned on and connected
   to the same network as this device.

2. Open a terminal in this folder and run:

       ./setup.sh

     - It finds the SnapPOS server on the network automatically.
     - If it finds more than one, it lists them and you pick yours.
     - If it finds none, type the address, e.g.  http://192.168.1.50:8420

3. A "SnapPOS" icon appears on the desktop and in the app menu. Open it to
   launch the register, full screen and locked to SnapPOS only.

To point this register at a different server later, run ./setup.sh again.

Exiting the kiosk
 - Press  Alt + F4  to close the full-screen register and return to the desktop
   - for maintenance, updates, or to point it at a different server. Reopen it
   from the SnapPOS icon.
 - In appliance mode (cage + autologin) there is no desktop to return to: exit
   by switching to another virtual terminal (Ctrl+Alt+F2) or your admin login,
   by design.

Notes
 - Nothing is stored on this device - it only shows the SnapPOS server.
 - Bundled Firefox is Linux x86_64. On a Raspberry Pi / ARM device, replace the
   firefox/ folder with an ARM Firefox and run ./setup.sh again.
 - For a fully locked till (a real appliance) use a single-purpose session:
       cage -- ./start-register.sh
   under an auto-login user, so there is no desktop to escape to. See README.md.
 - You keep Firefox updated here: replace the firefox/ folder now and then and
   run ./setup.sh again.
